home *** CD-ROM | disk | FTP | other *** search
/ United Public Domain Gold 2 / United Public Domain Gold 2.iso / utilities / pu677.dms / pu677.adf / Arexxguide2_0a.txt < prev    next >
Internet Message Format  |  1994-06-19  |  7KB
  1. Path: news.uh.edu!barrett
  2. From: tomv@vismag.limmat.net.ch (Thomas Voirol)
  3. Newsgroups: comp.sys.amiga.reviews
  4. Subject: REVIEW: ARexxGuide 2.0a hypertext manual for ARexx
  5. Followup-To: comp.sys.amiga.programmer
  6. Date: 17 Jun 1994 13:56:00 GMT
  7. Organization: The Amiga Online Review Column - ed. Daniel Barrett
  8. Lines: 209
  9. Sender: amiga-reviews@math.uh.edu (comp.sys.amiga.reviews moderator)
  10. Distribution: world
  11. Message-ID: <2tsa1g$jap@masala.cc.uh.edu>
  12. Reply-To: tomv@vismag.limmat.net.ch (Thomas Voirol)
  13. NNTP-Posting-Host: karazm.math.uh.edu
  14. Keywords: hypertext, AmigaGuide, ARexx, programming, shareware
  15. Originator: barrett@karazm.math.uh.edu
  16.  
  17.  
  18. PRODUCT NAME
  19.  
  20.     ARexxGuide 2.0a
  21.  
  22.  
  23. BRIEF DESCRIPTION
  24.  
  25.     ARexxGuide is an extensive hypertext document in AmigaGuide format
  26. on the ARexx programming language.
  27.  
  28.     Do not confuse it with the South West Amiga Group's similarly named
  29. "Introduction To ARexx".  This is an entirely different beast.
  30.  
  31.  
  32. AUTHOR/COMPANY INFORMATION
  33.  
  34.     Name:        Robin Evans
  35.     Address:    1020 Seneca #405
  36.             Seattle, WA  98101-2720
  37.             USA
  38.  
  39.     E-mail:        robin@halcyon.com       on Internet
  40.             R.EVANS6                on GEnie
  41.             r.evans6@genie.geis.com on Internet
  42.  
  43.     Availability:    ARexxGuide can be obtained from many local BBSs and
  44.             the Aminet ftp sites (util/rexx directory).
  45.  
  46.  
  47. LIST PRICE
  48.  
  49.     ARexxGuide is shareware. This means it is freely distributable, but
  50. if you find it useful, the author asks you to register.  The shareware fee
  51. is $15 (US).
  52.  
  53.     Registration can be done from within ARexxGuide.  A script asks you
  54. a few questions about your configuration and then assembles a text file
  55. which you can print out and mail in with the fee.
  56.  
  57.  
  58. SPECIAL HARDWARE AND SOFTWARE REQUIREMENTS
  59.  
  60.     HARDWARE
  61.  
  62.         Each ARexxGuide file is smaller than 75KB, so no extra RAM
  63.         should be necessary.
  64.  
  65.         A hard disk or a high density disk drive is recommended,
  66.         since a complete installation requires about 1 MB of disk
  67.         space.
  68.  
  69.     SOFTWARE
  70.  
  71.         AmigaOS 2.04 or later is required.
  72.  
  73.         It might work with AmigaDOS 1.3, however, if you have ARexx
  74.         and AmigaGuide or an equivalent of the latter like Hyper.
  75.  
  76.  
  77. COPY PROTECTION
  78.  
  79.     None.
  80.  
  81.  
  82. MACHINE USED FOR TESTING
  83.  
  84.     Amiga 3000T, 2MB Chip RAM, 16MB Fast RAM
  85.     Kickstart 40.68, Workbench 40.42
  86.     Multiview 40.8
  87.     Picasso II Graphics Board
  88.  
  89.  
  90. INSTALLATION
  91.  
  92.     Installation is a simple copy operation which can be done from
  93. Workbench.  No Assigns or Path additions are necessary.  If you invoke
  94. ARexxGuide from ToolManager or the likes, you should set the current
  95. directory to the one where ARexxGuide resides.
  96.  
  97.  
  98. REVIEW
  99.  
  100.     ARexxGuide starts with a nicely detailed, clearly arranged, main
  101. panel.  From here you jump directly to the relevant chapters.  Several entry
  102. points are given; that is, if you want to find a particular piece of
  103. information, there are usually several different "paths" that will lead you
  104. to it.
  105.  
  106.     If you are an ARexx beginner, you can browse through the Guide
  107. starting with the Introduction.  The document turns out to be a complete
  108. course in ARexx, at the end of which you will be able to write programs.  No
  109. prior knowledge of the language is necessary.  Even a small history of Rexx
  110. is included.
  111.  
  112.     The seasoned ARexx programmer also will find ARexxGuide to be an
  113. invaluable on-line reference.  The reference part of this documentation is
  114. divided logically into the chapters "Basic Elements", "Instructions",
  115. "Functions", "Operators", "Commands" and "Error Codes".
  116.  
  117.     ARexxGuide uses the hypertext capabilities of AmigaGuide
  118. extensively.  This makes for a very lucid tree structure.  You practically
  119. never have to read more than one or two pages of text, and almost every
  120. technical term is cross-referenced through a hypertext link.  Finally,
  121. ARexxGuide encompasses a very thorough index which is the fastest way to
  122. look up the syntax and arguments of a command whose name you already know.
  123.  
  124.     All pages show the path by which they can be reached in the window's
  125. drag bar.  On the bottom of each page, the Previous, Next and Contents links
  126. are displayed.  All this makes navigating really easy.
  127.  
  128.     Distributed with the regular ARexxGuide is a requester version that,
  129. according to the author, will display term definition references in a
  130. requester window instead of jumping to the glossary.  The requester version
  131. requires Nico Francois' reqtools.library and Rafael D'Halleweyn's
  132. rexxreqtools.library. However, since that Guide works properly only with V34
  133. of the AmigaGuide utility, I could not try it out.
  134.  
  135.  
  136. DOCUMENTATION
  137.  
  138.     Since ARexxGuide IS documentation, there is not too much to say
  139. about this part ;^).  Nevertheless, all the necessary meta-information (i.e.,
  140. Distribution, Author, Registration and others) is there and easily
  141. accessible.
  142.  
  143.  
  144. LIKES
  145.  
  146.     I like and appreciate the enormous amount of work and care the
  147. author has put into ARexxGuide. It is very thoroughly detailed and provides
  148. almost all knowledge relevant to ARexx.  I have not been able to spot any
  149. mistakes so far.
  150.  
  151.  
  152. DISLIKES AND SUGGESTIONS
  153.  
  154.     Dislikes I have to find yet.
  155.  
  156.  
  157. COMPARISON TO OTHER SIMILAR PRODUCTS
  158.  
  159.     The only product I know that is comparable to ARexxGuide is the
  160. aforementioned "Introduction To ARexx" by the South West Amiga Group.  While
  161. being a nice tutorial also, it lacks in the reference field and is not as
  162. clearly structured.
  163.  
  164.  
  165. BUGS
  166.  
  167.     None found. There obviously were some in the example scripts of the
  168. 2.0 release which have been fixed in 2.0a.
  169.  
  170.  
  171. VENDOR SUPPORT
  172.  
  173.     Besides releasing the bug-fixed version 2.0a, the author has provided
  174. a 50KB patch archive to upgrade an existing ARexxGuide 2.0 installation.
  175. Users of slower modems will be thankful that they don't have to download a
  176. whole new version.
  177.  
  178.  
  179. WARRANTY
  180.  
  181.     None mentioned.
  182.  
  183.  
  184. CONCLUSIONS
  185.  
  186.     I rate this product 10 stars out of 10. Honest. Robin Evans has
  187. provided us with an indispensable on-line help for ARexx where Commodore
  188. neglected to do so.
  189.  
  190.     The $15 shareware fee is fair compensation for the incredible amount
  191. of time and dedication the author has put into this documentation.  I
  192. encourage all ARexx programmers, seasoned or aspiring, to test this fine
  193. product and by all means send the shareware fee to Mr. Evans.
  194.  
  195.  
  196. REVIEW AUTHOR'S BACKGROUND
  197.  
  198.     I program in REXX for a living on IBM mainframe computers running
  199. under MVS/ESA, and I use IBM's very comprehensive TSO/E REXX documentation
  200. on a daily basis.
  201.  
  202.  
  203. COPYRIGHT NOTICE
  204.  
  205.     Copyright 1994 Thomas M. Voirol.  All rights reserved.
  206.  
  207.     Thomas M. Voirol        tomv@vismag.limmat.net.ch
  208.     Badenerstrasse 363        chwr9xv9@ibmmail.com
  209.     CH-8003 Switzerland
  210.     +41 1 400 16 42
  211.  
  212. +----------------------------+ +----//-----------------------+
  213. | Thomas M. Voirol           | | _ //    Zurich, Switzerland |
  214. | Certified Amiga Magician   | | \X/isual Magic Digital Arts |
  215. | tomv@vismag.limmat.net.ch  | |    ISDN: +41 (0)1 400 16 42 |
  216. +----------------------------+ +-----------------------------+
  217.  
  218.  
  219. ---
  220.  
  221.    Daniel Barrett, Moderator, comp.sys.amiga.reviews
  222.    Send reviews to:    amiga-reviews-submissions@math.uh.edu
  223.    Request information:    amiga-reviews-requests@math.uh.edu
  224.    Moderator mail:    amiga-reviews@math.uh.edu
  225.    Anonymous ftp site:  math.uh.edu, in /pub/Amiga/comp.sys.amiga.reviews
  226.